Release 10.1A: OpenEdge Development:
Progress 4GL Reference

OS-CREATE-DIR statement

Executes an operating system command from within Progress that creates a new directory.

Syntax

OS-CREATE-DIR { dirname | VALUE ( expression ) } ...

dirname

The name of the directory to create. If the directory already exists, no error is generated. If a file with this name exists, an error is generated. The name can be a pathname or a simple name.

If the dirname is not fully qualified, Progress will prepend the current working directory to the dirname.

VALUE ( expression )

An expression that returns the name of the directory to create. Expression can contain constants, field names, and variable names.

Example

The following procedure prompts the user for the name of a directory, then creates it. If the name you give is not fully qualified, the directory is created in your current directory.

r-os-dir.p

DEFINE VARIABLE stat AS INTEGER. DEFINE VARIABLE dir_name AS CHARACTER FORMAT "x(64)" LABEL "Enter the name of the directory you want to create.". UPDATE dir_name. OS-CREATE-DIR VALUE(dir_name). stat = OS-ERROR. IF stat NE 0 THEN MESSAGE "Directory not created. System Error #" stat.

Notes

The directory name must conform to the naming conventions of the underlying operating system.
If a specified directory cannot be created, Progress returns an error code.
Although an error can occur during execution of this statement, the statement does not generate an error message, raise an error condition, or affect the program’s flow in any way. Check for an execution error by using the OS-ERROR function and evaluating the return.

See also

OS-ERROR function